home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1995 October
/
EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso
/
Aminet
/
dev
/
gcc
/
ixemul_src.lha
/
ixemul-41.0
/
INSTALL
< prev
next >
Wrap
Text File
|
1995-06-13
|
6KB
|
158 lines
IXEMUL LIBRARY INSTALLATION NOTES
(last updated 6/12/95)
=====================
DISTRIBUTION CONTENTS
=====================
The net ixemul library distribution consists of two archives, one for the
runtime files and one for the source, where XXYY is the major and minor
version numbers:
ixemulXXYY-bin.lha ixemul.library, *crt*.o, includes, libc.a, etc
ixemulXXYY-src.lha Complete source code for ixemul library
Note that version 41.0 would be 4100 and 41.10 would be 4110.
The ixemulXXYY-bin.lha archive contains various readme and copyright files
that do not need to be installed anywhere, and another archive "runtime.lha"
that can be extracted relative to the gnu: directory to put all the files in
their standard location.
The ixemulXXYY-src.lha archive contains all the source, relative to a
directory "ixemul-XX.YY".
========================
INSTALLING RUNTIME FILES
========================
For the moment, you must manually install the files. Eventually there will
be an installer script available that you can use with the standard AmigaDOS
installer program to make installation more WorkBench friendly.
First make a work directory and unpack the archive. If you have sufficient
memory, the ram disk is a fine place for this:
makedir ram:ixemul
copy ixemulXXYY-bin.lha ram:ixemul
cd ram:ixemul
lha -mraxe x ixemulXXYY-bin.lha
Next backup any files in gnu: that will get overwritten during the install,
if you wish to preserve them. These files typically are:
gnu:bin/ixconfig
gnu:lib/bcrt0.o
gnu:lib/crt0.o
gnu:lib/rcrt0.o
gnu:lib/libc.a
gnu:lib/libb/libc.a
gnu:include (lots of files, but probably not all)
gnu:man (lots of files, but probably not all)
gnu:Sys/libs/ixemul* (all the old versions of the library)
Extract the contents of runtime.lha to the gnu: tree, overwriting any
existing copies of the files:
lha -mraxe x runtime.lha gnu:
By default, the version of ixemul.library that will be used is for any m68k
CPU and is not compiled to use an FPU. If you wish to install a version
better suited to your machine, say an 040 version using the built in fpu,
then do something like the following:
cd gnu:Sys/libs
rename ixemul.library ixemul000.library
copy ixemul040fpu.library ixemul.library clone
Then either reboot or run a program to flush the existing ixemul.library (if
any) from memory.
=======================
INSTALLING SOURCE FILES
=======================
To extract the source code, simple cd to a directory where you would like
the source code directory to be created, and extract the source archive
there:
cd gnu-src:
lha -mraxe x ixemulXX.YY-src.lha
Note that this will create the directory ixemul-XX.YY and populate it with
all the source files.
To rebuild the library, all that is needed is to run the configure script
and then run make. Note that at the moment, you have to use separate build
and source directories. That is, you leave the source tree untouched and
create a separate build tree in which all the compiled files will be placed.
I.E.:
cd gnu-build:
makedir ixemul-XX.YY (must not be source directory at the moment)
cd ixemul-XX.YY
sh /gnu-src/ixemul-XX.YY/configure m68k-cbm-amigados
This will create a Makefile and several subdirectories with other Makefiles.
Note the section in the Makefile that looks like:
all:
$(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
$(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
$(MAKE) build CPU=68020 FPU=68881 BASE=no-baserel
$(MAKE) build CPU=68020 FPU=68881 BASE=baserel
$(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
$(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
$(MAKE) build CPU=68030 FPU=68881 BASE=no-baserel
$(MAKE) build CPU=68030 FPU=68881 BASE=baserel
$(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
$(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
$(MAKE) build CPU=68040 FPU=68881 BASE=no-baserel
$(MAKE) build CPU=68040 FPU=68881 BASE=baserel
@(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
By default, all of the versions of ixemul.library are build by make. This
can take a very long time (about a day on a 40MHz 040 WarpEngine for
example, probably much longer on other machines).
If you only want to build one particular version of the library and runtime
files to test, just comment out the lines you don't want. I.E. to build a
68040+68881 version, the above lines should be changed to:
all:
$(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
$(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
# $(MAKE) build CPU=68020 FPU=68881 BASE=no-baserel
# $(MAKE) build CPU=68020 FPU=68881 BASE=baserel
# $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
# $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
# $(MAKE) build CPU=68030 FPU=68881 BASE=no-baserel
# $(MAKE) build CPU=68030 FPU=68881 BASE=baserel
# $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
# $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
$(MAKE) build CPU=68040 FPU=68881 BASE=no-baserel
$(MAKE) build CPU=68040 FPU=68881 BASE=baserel
@(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
Note that you have to build the 68000 version in any case, since the
compiler runtime files (*crt*.o, libc.a, libbc.a) are generic 68000 code.
Then just run "make" in the build directory:
cd gnu-build:ixemul-XX.YY
make
==============
REPORTING BUGS
==============
Please report problems or bugs to Fred Fish (fnf@amigalib.com), who is the
current ixemul library coordinator. Even better than a bug report is a bug
fix, which typically would be a context diff file for one or more ixemul
source files.
-Fred Fish (fnf@amigalib.com)